home *** CD-ROM | disk | FTP | other *** search
/ Aminet 2 / Aminet AMIGA CDROM (1994)(Walnut Creek)[Feb 1994][W.O. 44790-1].iso / Aminet / gfx / pbm / netpbm1.lha / netpbm / README.VMS < prev    next >
Text File  |  1993-12-02  |  7KB  |  130 lines
  1.     Hi VAX/VMS and future PBMplus users!!!
  2.  
  3.         This version of Jef Poskanzer's PBMplus package is ready-made to
  4.     support the DEC VAX/VMS C environment.  In an attempt to make it run
  5.     like the Unix environment, the  programs  have been modified to look
  6.     like they use the "piping" and  "redirection"  features  of Unix and
  7.     MSDOS.  In this way, the documentation  and  other people's comments
  8.     (i.e.,  USENET  alt.graphics.pixutils discussions, etc.) will be the
  9.     same for all platforms.
  10.  
  11.         This  VMS  implementation  borrows  heavily  from  the  previous
  12.     PBMplus/VMS release  by  Rick Dyson for 10dec91 which in turn builds
  13.     on the work  Terry  Poot (tp@mccall.com) did for the 05feb91 general
  14.     release of PBMplus.   Many thanks and credits go his direction.  The
  15.     "piping/redirection"    is    attributed    to    Mark     Pizzolato
  16.     (mark@infopiz.uucp).  The creation of the  shareable  library is due
  17.     to work done by Dave Jones (JONESD@kcgl1.eng.ohio-state.edu).
  18.  
  19.         Well, since you are reading this, I  guess  you have the PBMplus
  20.     kit and have broken it out into it's  respective  directories.    At
  21.     this  point you just have to start the build  operation.    In  this
  22.     release  of the PBMplus package the process is much easier  than  in
  23.     the past.  There is no patching of the source code necessary  and so
  24.     there is no  extra  "patch-build kit".  This contains everything you
  25.     need to build the PBMplus package.
  26.     
  27.         There is only one step to the preparation process and that is to
  28.     copy  all the files from the [.VMS] sub-directory up one level  into
  29.     the  root  [PBMplus]  directory.
  30.  
  31. "MAKEFILE.MMS"
  32. -------------
  33.         There are  two  methods  of building the executables.  The first
  34.     (and prefered) method  uses DECs "makefile" utility, MMS, which uses
  35.     the "MAKEFILE.MMS" files.   If  you  don't  have  MMS,  skip  to the
  36.     section labeled "MAKE_PBMPLUS.COM" below.  If you are still with me,
  37.     just  type  "MMS  /Description  =  Makefile.MMS"    and  follow  the
  38.     directions outlined on the screen.  Your most probable sequence will
  39.     be the something like the following:
  40.  
  41. $ MMS /Description = Makefile.MMS ALL
  42. $ MMS /Description = Makefile.MMS INSTALL   ! creates & loads [.Exe]
  43. $ MMS /Description = Makefile.MMS HELP      ! make PBMPLUS.HLB
  44. $ MMS /Description = Makefile.MMS MANUAL    ! will need LaTeX and tr2TeX...
  45. $ MMS /Description = Makefile.MMS INSTALLMANUAL ! creates & loads [.TeX]
  46. $ MMS /Description = Makefile.MMS CLEAN     ! clean up all recoverable files
  47.  
  48.         The  available  choices  will  be  displayed  if you  don't  say
  49.     anything, i.e.
  50.  
  51.             $ MMS /Description = Makefile.MMS
  52.  
  53. "MAKE_PBMPLUS.COM"
  54. ------------------
  55.         The  other  method  of  building the package is to  execute  the
  56.     "MAKE_PBMPLUS.COM" command  procedure.    This was mostly created by
  57.     the "MMS BUILD_PROC"  command.    It  is not as flexible as MMS, but
  58.     should get the job done.  Look  through the procedure and edit it as
  59.     you see fit.  It builds and installs  just  about  everything, so it
  60.     might be in your best interest to look through  it and use your veto
  61.     powers to comment out the unneeded (or unavailable) parts.   Be sure
  62.     to look and check what you have before executing the procedure.
  63.  
  64. "SETUP.COM"
  65. -----------
  66.         I  have  provided  two  setup  files  with  this distribution to
  67.     facilitate  the  day-to-day use of PBMplus.  All you need to  do  is
  68.     execute  the  SETUP.COM  command  procedure and it will make all the
  69.     logical name  and  foreign  symbol  definitions.    You  should look
  70.     through SETUP.COM and  read  the  comments  about the rooted logical
  71.     names used.  After  all  that, look through the TeX documentation or
  72.     the on-line help files to get an idea of how to start using PBMplus.
  73.     
  74.         NOTE:    An  error  in  MMS will occur if you  have  used
  75.         SETUP.COM before  using  MMS.  A logical name conflict or
  76.         something.  Either  logout  and login to clear things out
  77.         or  Deassign PBMplus_Root and  PBMplus_Dir  before  using
  78.         MMS.
  79.     
  80. Manifest
  81. --------
  82.         The following files are included  with this VMS port of PBMplus.
  83.     The bare essential ones needed to complete the build are marked with
  84.     an astreisk (*):
  85.  
  86.         [.VMS]MAKEFILE.MMS     -- VMS MMS description file (i.e., "makefile")
  87.                                   for all of PBMplus
  88.        *[.VMS]MAKE_PBMPLUS.COM -- VMS command procedure produced by MMS to build
  89.                                   the PBMplus package for users without MMS
  90.        *[.VMS]MAKE_PBMPLUSSHR.COM -- VMS command procedure to build Shareable
  91.                                   link library of the four main PBMplus object
  92.                                   libraries; LIBPBM, LIBPGM, LIBPPM, & LIBPNM
  93.         [.VMS]SETUP.COM        -- An initialization/definition command proc for
  94.                                   "everyday use" of PBMplus once it's built
  95.         [.VMS]ADD_LIST.COM     -- Generic command procedure to add another
  96.                                   library to any VMS librarian list, (i.e.,
  97.                                   Hlp$Library_nn or Lnk$Library_nn)
  98.         [.VMS]PBMPLUS.HLP      -- VMS Help library file for all of PBMplus
  99.         [.PBM]MAKEFILE.MMS     -- VMS MMS description file for PBM routines
  100.         [.PGM]MAKEFILE.MMS     -- VMS MMS description file for PGM routines
  101.         [.PPM]MAKEFILE.MMS     -- VMS MMS description file for PPM routines
  102.         [.PNM]MAKEFILE.MMS     -- VMS MMS description file for PNM routines
  103.         [.LIBTIFF]MAKEFILE.MMS -- VMS MMS description file for LIBTIFF routines
  104.  
  105.         When it's all over and done, the  PBMplus  directory tree should
  106.     resemble  the following:
  107.  
  108.     PBMPLUS  ---+ EXE                           <-- the binaries
  109.                 |
  110.                 + LIBTIFF                       <-- TIFF library
  111.                 |
  112.                 + PBM                           <-- Portable BitMaps
  113.                 |
  114.                 + PGM                           <-- Portable Grayscale Maps
  115.                 |
  116.                 + PNM                           <-- Portable aNy Maps
  117.                 |
  118.                 + PPM                           <-- Portable Picture Maps
  119.                 |
  120.                 + VMS                           <-- VMS specific files
  121.  
  122. Rick Dyson
  123. --
  124. Richard L. Dyson               INTERNET:  Dyson@IowaSP.Physics.UIowa.EDU
  125.  _   _      _____    Graduate Research Assistant        O: 319/335--1879
  126. | | | |    |_   _|   Department of Physics & Astronomy  H: 319/338--6117
  127. | | | | of   | |     Van Allen Hall            NSI/DECnet: IOWASP::DYSON
  128. | \_/ |     _| |_    University of Iowa               or :   7231::DYSON
  129.  \___/     |_____|   Iowa City, IA 52242-1479
  130.